home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / XmDeactivateProtocol.z / XmDeactivateProtocol
Encoding:
Text File  |  2003-11-18  |  3.8 KB  |  67 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmDDDDeeeeaaaaccccttttiiiivvvvaaaatttteeeePPPPrrrroooottttooooccccoooollll((((3333XXXX))))  UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV  XXXXmmmmDDDDeeeeaaaaccccttttiiiivvvvaaaatttteeeePPPPrrrroooottttooooccccoooollll((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       _X_m_D_e_a_c_t_i_v_a_t_e_P_r_o_t_o_c_o_l - A VendorShell function    that
  10.       deactivates a    protocol without removing it
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       #include <Xm/Xm.h>
  14.       #include <Xm/Protocols.h>
  15.  
  16.       void XmDeactivateProtocol (sssshhhheeeellllllll,,,, pppprrrrooooppppeeeerrrrttttyyyy,,,, pppprrrroooottttooooccccoooollll)
  17.            _W_i_d_g_e_t     sssshhhheeeellllllll;
  18.            _A_t_o_m     pppprrrrooooppppeeeerrrrttttyyyy;
  19.            _A_t_o_m     pppprrrroooottttooooccccoooollll;
  20.  
  21.       _v_o_i_d _X_m_D_e_a_c_t_i_v_a_t_e_W_M_P_r_o_t_o_c_o_l (sssshhhheeeellllllll,,,, pppprrrroooottttooooccccoooollll)
  22.            _W_i_d_g_e_t     sssshhhheeeellllllll;
  23.            _A_t_o_m     pppprrrroooottttooooccccoooollll;
  24.  
  25.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  26.       _X_m_D_e_a_c_t_i_v_a_t_e_P_r_o_t_o_c_o_l deactivates a protocol without removing
  27.       it.  It updates the handlers and the pppprrrrooooppppeeeerrrrttttyyyy, if the    sssshhhheeeellllllll
  28.       is realized.    It is sometimes    useful to allow    a protocol's
  29.       state    information (callback lists, etc.) to persist, even
  30.       though the client may    choose to temporarily resign from the
  31.       interaction.    The main use of    this capability    is to
  32.       gray/ungray _f._s_e_n_d__m_s_g entries in the    Mwm system menu.  This
  33.       is supported by allowing a pppprrrroooottttooooccccoooollll to be in one of two
  34.       states:  active or inactive.    If the pppprrrroooottttooooccccoooollll    is active and
  35.       the sssshhhheeeellllllll is realized, the pppprrrrooooppppeeeerrrrttttyyyy contains the pppprrrroooottttooooccccoooollll
  36.       _A_t_o_m.     If the    pppprrrroooottttooooccccoooollll is inactive, the _A_t_o_m is not present
  37.       in the pppprrrrooooppppeeeerrrrttttyyyy.
  38.  
  39.       _X_m_D_e_a_c_t_i_v_a_t_e_W_M_P_r_o_t_o_c_o_l is a convenience interface.  It calls
  40.       _X_m_D_e_a_c_t_i_v_a_t_e_P_r_o_t_o_c_o_l with the    property value set to the atom
  41.       returned by interning    _W_M__P_R_O_T_O_C_O_L_S.
  42.  
  43.       sssshhhheeeellllllll
  44.            Specifies the widget with which the protocol property
  45.            is associated
  46.  
  47.       pppprrrrooooppppeeeerrrrttttyyyy
  48.            Specifies the protocol property
  49.  
  50.       pppprrrroooottttooooccccoooollll
  51.            Specifies the protocol atom (or an int type cast    to
  52.            Atom)
  53.  
  54.       For a    complete definition of VendorShell and its associated
  55.       resources, see _V_e_n_d_o_r_S_h_e_l_l(_3_X).
  56.  
  57.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  58.       _m_w_m(_1_X), _V_e_n_d_o_r_S_h_e_l_l(_3_X), _X_m_D_e_a_c_t_i_v_a_t_e_W_M_P_r_o_t_o_c_o_l(_3_X),    and
  59.       _X_m_I_n_t_e_r_n_A_t_o_m(_3_X).
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/11/03)
  64.  
  65.  
  66.  
  67.